=========================================================================
USER GUIDE: Berry Good Auction Manager
=========================================================================

TABLE OF CONTENTS
  0. Installation & Setup
  1. How This System Works
  2. Getting Started
  3. Creating an Auction
  4. Clerking (The Live Auction)
  5. Cashiering (Checkout)
  6. Understanding Reports
  7. Safety & Backups
  8. System Settings
  9. Staff Management (Adding Users)
 10. Team Alerts
 11. Email Setup (Optional)
 12. Trial Mode Limits

=========================================================================
0. INSTALLATION & SETUP (Read First)
=========================================================================

No Installation Required: This software is a portable application.
You do not need to run an installer. To start the program, simply
double-click the BerryGoodAuctionManager.exe file.

Moving the Software: All your auction data (database and settings)
is stored in the files next to the application.

CRITICAL: If you ever want to move the software (e.g., to a USB
drive or a different folder), you must move the entire folder
containing the .exe and its accompanying files. Do not move the
.exe file by itself, or you will lose your data and the program
will fail to start.

Recommendation: We strongly recommend keeping the main folder in
a permanent location (like your "Documents" folder) and creating
a Shortcut on your Desktop if you need quick access.

=========================================================================
1. HOW THIS SYSTEM WORKS (Read First)
=========================================================================

Unlike standard programs that you install on every computer, this
software runs as a Local Web Server.

The "Host" (Main Computer):
  Only one computer needs to run the software (usually the Clerk's
  computer). This computer holds the database.

The "Clients" (Other Computers):
  Other computers (like the Cashier station) do not run the program.
  They simply connect to the Host over Wi-Fi using a web browser
  (Chrome, Edge, etc.).

Network Requirement:
  All computers must be connected to the same Wi-Fi network or
  wired LAN to communicate with each other.

=========================================================================
2. GETTING STARTED
=========================================================================

Launching the Server
--------------------
1. On the Host Computer, find the folder containing the software.
2. Double-click BerryGoodAuctionManager.exe.
3. A black window will appear. Do not close this window; closing
   it stops the software!
4. Your default web browser will automatically open to the login page.

Logging In
----------
Default Username: admin
Default Password: BerryGoodAuctionManager123

We recommend changing your password after your first login. You
can do this from the Settings page (see Section 8).

Connecting a Second Computer (Cashier)
--------------------------------------
1. Look at the top of the Dashboard on the Host computer. You will
   see a Network Access card with a URL
   (e.g., http://your-computer-name:8000/ or http://192.168.1.15:8000/).
2. Go to the second computer (Cashier) and ensure it is on the
   same Wi-Fi network.
3. Open a web browser and type that exact URL into the address bar.
4. You are now connected to the main system.

If you get an error, make sure both computers are connected to the
same wireless network.

=========================================================================
3. CREATING AN AUCTION
=========================================================================

Before you can sell items, you must create the "Auction Event."

1. Click "Add New Auction" on the Dashboard (or use the Auctions
   dropdown in the navigation bar).
2. Name: Enter a name (e.g., "Smith Estate Sale - Oct 2026").
3. Date: Select the auction date.
4. Starting Cash: Enter the amount of money in the cashier's
   drawer (e.g., $200.00).
5. Percentages: Verify the Buyer's Premium (fee added to sales)
   and Sales Tax rates are correct.
6. Click Save.

Note: You generally do not need to re-enter sellers if they have
sold with you before; the system remembers them. Only use
"Add New Seller" for brand-new consignors. Use "Add New Buyer"
to check in customers and assign Bidder Numbers.

=========================================================================
4. CLERKING (The Live Auction)
=========================================================================

This is the screen used to record sales in real-time. Go to the
Clerking dropdown and select "Live Clerking."

The Interface
-------------
  Lot #:    Auto-fills sequentially. If you just sold Lot 5, it
            suggests Lot 6.
  Seller #: "Sticky" field. It remembers the last Seller # you
            typed, so you don't have to re-type it if one seller
            is selling 10 items in a row.
  Quantity: Defaults to 1. Change this for "times the money" bids
            (e.g., 3 items at $10/each).

Critical Keybinds (Speed Controls)
-----------------------------------
Speed is essential during the live call. Use these keys instead
of clicking:

  ENTER        Submit & Advance
               Use for normal sales. Saves the sale and moves to
               the next whole lot number (e.g., Lot 5 -> Lot 6).

  DOWN ARROW   Submit & Stay (Sub-lots)
               Use for splitting lots. Saves the sale but keeps
               the same Lot Number to create sub-lots
               (e.g., Lot 5a -> Lot 5b).

  ALT + Click  Copy Row
               Hold Alt and click a previous row in the "Logged
               Sales" list. It copies that item's Title, Price,
               and Seller # into your input box. Perfect for
               "Choice" bids.

Single Item Add (Kitchen / Misc):
  For food or miscellaneous items that shouldn't mess up your main
  lot count, use the "Single Item Add" page (under the Clerking
  dropdown). These are assigned high lot numbers (90000+)
  automatically.

=========================================================================
5. CASHIERING (Checkout)
=========================================================================

Click "Cashiering" in the navigation bar to finalize transactions.

Setting Up the Customer Display (TV) - Optional
-------------------------------------------------
1. Connect a TV/Monitor to the cashier computer.
2. In Windows Display settings, set the display mode to "Extend"
   (not Duplicate).
3. On the Cashier page, click "Launch Display."
4. Drag the new window onto the TV screen and make it full screen.
   The display will show each buyer's invoice as you process them.

Taking Payment
--------------
1. Search: Type the Buyer's Name or Bidder Number.
2. Review: Click their row to open the Invoice. Verify the items
   with the customer (they can see them on the TV if connected).
3. Pay: Scroll to "Add Payment."
     - Cash/Check: Enter the amount. The system calculates
       change due.
     - Card: The system automatically adds the convenience fee
       (e.g., 3%) to the total. Enter this new total into your
       credit card terminal.
4. Finish: Once the balance hits $0.00, the status updates to
   "Paid." You can then print a receipt or email it to the buyer.

=========================================================================
6. UNDERSTANDING REPORTS
=========================================================================

The software generates several reports to help you balance the
books at the end of the night. Access them via the "Admin &
Reports" dropdown in the navigation bar.

  Auction Financial Summary
    The "Big Picture." Shows total Gross Sales, total
    Cash/Check/Card collected, and calculates if your cash
    drawer matches the expected balance.

  Seller Reports & Payouts
    Used to write checks to consignors. You enter the
    Commission % and any Spot Fees; it calculates exactly
    what you owe the seller (Net Payout).

  Cash Log / Check Log / Credit Card Log
    Audit lists. Shows every single payment made by method.
    Use these if your drawer is off to find the mistake.

  Master Sales Log
    Complete list of every sale across the auction, sortable
    and searchable.

  Adjustment Log
    The "Audit Trail." Shows a history of every time a clerk
    edited or deleted a sale during the auction. Useful for
    security and finding missing items.

  Analytics Dashboard
    Visual charts showing trends across auctions: top buyers,
    top sellers, average sale prices, and more.

=========================================================================
7. SAFETY & BACKUPS
=========================================================================

Database File:
  Your data lives in a file named db.sqlite3, located in the
  same folder as the .exe.

Backup:
  Copy the db.sqlite3 file to a USB drive or cloud storage after
  every auction to keep it safe.

Power Failure:
  If the power goes out, simply restart BerryGoodAuctionManager.exe.
  No data will be lost because every sale is saved instantly when
  you press Enter.

=========================================================================
8. SYSTEM SETTINGS
=========================================================================

Access the Settings page from the "Admin & Reports" dropdown in the
navigation bar and select "Settings."

The Settings page has three tabs:

General & Financial
-------------------
  Company Name: Updates the branding shown in the top navigation
  bar and on emails.

  Kitchen Seller #: Defines which seller number is used for
  concession / kitchen sales.

  Auction Address: Enter your street address, city, state, and
  zip code. This appears on invoices and receipts.

  Invoice Footer Text: Custom text at the bottom of every printed
  invoice (e.g., "All Sales Final").

  Default Rates: Set the standard Buyer's Premium and Sales Tax
  percentages used when creating new auctions.

  Company Logo: Upload your logo to display in the application
  and on printed documents.

Email Configuration
-------------------
  See Section 11 for full email setup instructions.

Staff Management
----------------
  See Section 9 for adding and managing user accounts.

=========================================================================
9. STAFF MANAGEMENT (Adding Users)
=========================================================================

You can create separate logins for different clerks or cashiers
directly from the Settings page.

1. Go to Settings (Admin & Reports > Settings).
2. Click the "Staff Management" tab.
3. Click the green "Add New User" button.
4. Fill in the details:
   - Username: The login name (e.g., clerk1).
   - First Name / Last Name: Optional, for identification.
   - Email: Optional, for system notifications.
   - Password: A password for their account.
   - Grant Admin Access: Check this ONLY if you want this user
     to be able to delete auctions or change system settings.
5. Click "Create User."

To remove a user, click the red trash icon next to their name in
the Staff Management table. You cannot delete the account you are
currently logged into.

=========================================================================
10. TEAM ALERTS
=========================================================================

Need to tell the cashier something without shouting across the room?

1. Click the yellow "Alert Team" button in the navigation bar.
2. Type a message (e.g., "Hold payment for Buyer #105").
3. Click "Send Broadcast."

This message will instantly pop up on every screen connected to
the system. Staff can reply directly from the notification.

=========================================================================
11. EMAIL SETUP (Optional)
=========================================================================

To send receipts and invoices directly from the software, you must
configure your email provider in the Settings page.

1. Go to Settings (Admin & Reports > Settings).
2. Click the "Email Configuration" tab.
3. Fill in:
   - Provider Host: Your email provider's SMTP server
     (e.g., smtp.gmail.com for Gmail).
   - Port: Usually 587 for TLS.
   - Use TLS Security: Check this box (recommended).
   - Email Address: Enter your full email address.
   - Email Password: Enter your App Password (see below).
   - "From" Address: How the sender name will appear
     (e.g., Your Auction Co <auction@gmail.com>).
4. Click "Save Settings."

How to Get a Gmail App Password
-------------------------------
Google does not allow third-party apps to use your main password.

1. Go to your Google Account Settings.
2. Enable 2-Step Verification if it isn't already on.
3. Search for "App Passwords" in the search bar.
4. Create a new app password (name it "Auction Software").
5. Google will give you a 16-character code.
6. Copy this code and paste it into the Email Password field.

Troubleshooting
---------------
  "SMTPAuthenticationError": Your App Password is wrong, or
  2-Step Verification is off.

  "ConnectionRefused": Check that your firewall or antivirus
  is not blocking the software from accessing the internet.

=========================================================================
12. TRIAL MODE LIMITS
=========================================================================

This is the free trial version of Berry Good Auction Manager.
All features are fully functional, but data capacity is limited:

  - Up to 2 auctions
  - Up to 10 buyers
  - Up to 5 sellers
  - Up to 20 sale items

When you reach a limit, you will see a "Trial Limit Reached"
message. No data is lost — upgrading to a full license removes
all limits and unlocks unlimited use.

No license key is required to use the trial. Simply run the
software and start exploring.

To purchase a full license, visit:
  https://huntertyberry.com/software/

=========================================================================
SUPPORT
=========================================================================

For questions, setup help, or to purchase a full license, visit:
  https://huntertyberry.com/software/

Or use the contact form on the website.

=========================================================================
